Node / meshtastic / Meshtastic-Android / files / docs / et-rEE / user / mqtt.md

Displaying Rendered • View raw • Download

title: MQTT

parent: User Guide

nav_order: 11

last_updated: 2026-05-13

description: Silda oma võrk internetiga – MQTT maakleri seadistamine, krüpteerimiskihid ja kaardiaruandlus.

aliases:

• mqtt

• internet-bridge

• broker

MQTT ühendab Meshtastic võrgu internetiga, võimaldades raadiolevi ulatusest kaugemale ulatuvat pikamaasidet.

MQTT moodul ühendab sinu sõlme MQTT vahendajaga, võimaldades:

• Messages to reach nodes on different physical meshes via the internet

• Integration with home automation and monitoring systems

• Sõlmede asukoha avaldamine avalikul Meshtastic kaardil

• Custom data pipelines for logging and alerting

T282828

Internetiühendusega (WiFi või Ethernet) lüüsisõlm jagab võrgusõnumeid MQTT. Sama teemaga liitunud kauglüüsid sisestavad need sõnumid oma kohalikku kärgvõrku.

1. Mine menüüsse Seaded → Mooduli konfiguratsioon → MQTT.

2. Luba MQTT moodul.

3. Configure the broker connection:

!MQTT lüliti

Kui sõlmel puudub oma internetiühendus, saab see kasutada ühendatud telefoni MQTT-lüüsina: luba mooduli konfiguratsioonis MQTT ja Proksi kliendiga lubatud ning rakendus edastab MQTT-liikluse raadio ja maakleri vahel telefoni internetiühenduse kaudu.

MQTT sätete ekraani ülaosas olev lüliti MQTT puhverserver sellel telefonil näitab, kas see relee töötab praegu, ja võimaldab selle kohe välja lülitada (või taaskäivitada) – ilma seadme MQTT konfiguratsiooni muutmata ja uuesti salvestamata.

Kogukond haldab avaliku vahendajat aadressil T383838mqtt.meshtastic.org. This is intended for general use and testing.

│ ℹ️ Märkus: Ühendused saidiga T383838mqtt.meshtastic.org kasutavad alati TLS-i (port 8883), isegi kui

│ TLS-i lüliti on välja lülitatud. For any other broker, TLS is used only when you enable it (port

│ 8883 with TLS, 1883 without).

│ 🔒 Privaatsus: Avaliku vahendaja sõnumeid saavad lugeda kõik tellijad. Privaatse suhtluse jaoks

│ kasuta alati kanali krüpteerimist.

Parema privaatsuse ja kontrolli tagamiseks saad hallata oma MQTT maaklerit:

• Mosquitto (lightweight, open-source)

• HiveMQ

• EMQX

Configure your node to point to your private broker with appropriate credentials.

Kui kaardiaruandlus on lubatud, avaldab sõlm oma asukoha Meshtasticu kogukonnakaardil:

• Nähtav aadressil meshmap.net ja sarnastes kogukonna kaarditeenustes

• Only position and node info are shared

• Keela see valik, kui sa ei soovi, et sinu asukoht oleks avalikult nähtav

Konfi iga kanali kohta, millised suunad on aktiivsed, et kontrollida sõnumivoogu ja eetriaega.

MQTT kasutab protobuf-sõnumivormingut:

│ ⚠️ Märkus: JSON väljundi tugi eemaldati püsivarast. Säte T383838json_enabled on rakenduses endiselt

│ nähtav, et näha ka pärandühilduvust, kuid see ei mõjuta praegusi püsivara versioone.

Understanding the layered encryption model:

1. Kanali krüptimine toimub kärgvõrgus enne MQTT. Kui kanalil on PSK, on ​​MQTT liiklus juba krüptitud – maakler ja kõik tellijad näevad ainult šifriteksti.

2. MQTT krüptimine (mooduli säte) lisab vahendajale edastamiseks täiendava krüptimiskihi. This protects metadata and routing information.

3. TLS krüpteerib TCP ühenduse vahendaja endaga, takistades võrgutasandil pealtkuulamist.

│ 🔒 Tähtis: Vaikimisi avalikul kanalil on tuntud võti. MQTT kaudu saadetud vaikekanalil olevad

│ sõnumid on sisuliselt krüpteerimata – igaüks saab neid dekodeerida. Always use a custom PSK for

│ private communications.

• Kasuta kanali krüptimist (PSK), kanalitel mis on sillatud MQTT-ga

• Ära luba MQTT internetiühenduseta sõlmedel (see puhverdab ja raiskab mälu)

• Use a private broker for sensitive deployments

• MQTT sõnumite allalaadimisel arvesta eetriaja kuluga – iga allalingitud sõnum tarbib sinu kohalikus võrgus raadioeetriaega

• Kaalu ainult üleslingi lubamist, kui sul on vaja oma kärgvõrku eemalt jälgida ilma sõnumeid tagasi tõmbamata

• Kontrolli WiFit – lüüssõlmel peab olema aktiivne internetiühendus (WiFi või Ethernet). MQTT ei tööta LoRa raadiolingi enda kaudu.

• Verify credentials — incorrect username or password will silently fail on most brokers. Double-check for trailing spaces.

• Tulemüür — port 1883 (MQTT) või 8883 (MQTT+TLS) peab olema avatud. Some networks block non-standard ports.

• DNS-i lahendamine – kui kasutad kohandatud maakleri hostinime, veenduge, et sõlm suudab seda lahendada. Try the broker's IP address directly.

• Kontrolli üleslingi/allalingi seadeid — kui lubatud on ainult üleslink, liiguvad sõnumid võrgust MQTT-sse, aga mitte tagasi. Luba vastuvõtval lüüsil allalink.

• Kanali mittevastavus – mõlemad lüüsid peavad jagama sama kanalit sama PSK-ga. Vastuolu tähendab, et sõnumid on krüpteeritud erinevate võtmetega ja kuvatakse prügina.

• Teema mittevastavus — veendu, et mõlemad lüüsid kasutaksid sama juurteemat. The default T383838msh works for the public broker.

• Seaded — Moodulid ja administreerimine — MQTT mooduli konfi viide

• Sõnumid ja kanalid — kanali krüptimine ja PSK seadistamine

• MQTT integratsioonijuhend — üksikasjalik MQTT dokumentatsioon aadressil meshtastic.org